Determines the current default volume and possibly also the default directory.

OSErr GetVol (
    StringPtr volName, 
    SInt16 *vRefNum
);

volName

On return, a pointer to the name of the default volume.

vRefNum

On return, a pointer to a volume reference number or a working directory reference number.

If the default directory has a working directory associated with it, the vRefNum parameter instead contains a working directory reference number (which encodes both the volume reference number and the default directory ID). However, if, in a previous call to HSetVol (or PBHSetVolSync or PBHSetVolAsync ), a working directory reference number was passed in, GetVol returns a volume reference number in the vRefNum parameter.

function result

A result code.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

Carbon applications should use HGetVol and HSetVol to get and set the default directory. GetVol and SetVol are no longer supported and working directories are not supported.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)